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ABSTRACT and CONTENTS 



Specifies standard means of communication between processes 
and the Model 30 via a standard interface process M30COM. 
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Introduction 

The standard procedure for communications with a device on 
the M30 will be basically as follows: The process concerned 
will first call a utility to 'open' the device it wishes to 
use. Data from this call (which the utility will pass to 
M30COM via the file M30Q) will be the process's complete name, 
the complete name of a file to be used for communications with 
M30COM, and the number of the device to be opened. M30COM 
will check to see that the device is available, and if it is, 
then it will initialize part of itself accordingly and return 
via M30Q an interrupt number. The utility will return this 
number to the calling process, which should use it thenceforward 
for communication with M30COM. 

From then on, data will be passed between M30COM and the 
user process via a ring buffer within the first page of the 
user communication file. The user will interrupt M30COM when 
he has requests to be serviced, and M30COM will interrupt the 
user ( if he so requests) as the requested actions are completed 
Requests may be for action (with/without data transfer between 
the M30 and the communications file) on the open device, or 
for messages (with/without reply) for the operator. 
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I . Opening a device 

The first page of M30Q contains a small slot for opening 

requests (figure 1) . The entry in this table is 17 words 

long; space for a unique device number, the complete process 

name and a complete file name. The user should call a 

utility which will be provided to make his entry, open M30COM 

and fire interrupt 10 at it. M30COM will respond to the 

utility with * specified interrupt once it has picked up the request 

Word 2 of the request entry, which the utility will return to 

the user, originally contained the device number, and will now 

either contain an interrupt number, or -1 if the device was ' 

not available. If the device was not available, the utility 

will FRETURN, otherwise it will RETURN the interrupt number. 

If an interrupt number is returned, the user is cleared 

to access the device, using that interrupt to inform M30COM 

of its requests. 



bcc 



p/c-n.r 

M30/S-7 



page 



M30Q Page 



LOCK 



1 bit jQ FLAG 



bits 1-23 INTN 



2 DNUM 



3-9 PRONAME 



10-16 FILE 



software lock 

done flag, set by M30COM when 
it has picked up the open- 
ing request 

interrupt number to be used 
by M30COM to interrupt the 
calling utility 

Device number (interrupt 
number or -1 after) 

complete process name 



complete file name (includes 
USN, DKA, NAME, TYPE in 
that order) 



Figure 1 
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II. Communications with M30COM 
after a device is open 

The first page of the users communication file, hereinafter 

referred to as COMF, must contain a ring buffer, which 

will be used to pass requests to M30COM. The first four 

words of this page must be the reader pointer, the writer 

pointer, the bottom, and the top of the buffer in that 

order. Moreover, the buffer as defined by BOTTOM and TOP 

must lie wholly within this page, BOTTOM < RP < TOP and 

BOTTOM < WP < TOP at all times. Entries in this queue are 

8 words long, consisting of an operation specification, 

starting address, word count, direct data, and space for error 

information (figure 2) . Each entry specifies whether or not 

the process is to be interrupted on completion of the 

operation to be performed. When the process has one or 

more entries to be passed to M30COM, it should fire the 

the interrupt provided when it opened the device at M30COM. 

M30COM will pick up requests starting at the reader pointer, 

and continuing until it hits the writer pointer. M30COM 

will then carry out the requests in the order given'. Every timfe it 

finishes a request which specified an interruption on completion 

it will update the reader pointer and interrupt the user 

process. It will also do this when it has finished the 

entire block of requests, whether or not the last entry 

specified an interrupt. If at any time a persistent error 

occurs during the servicing of a request, the error flag 

will be set in the entry which generated the error, the 
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reader pointer will be set to the first entry after that 
entry (i.e., ready to continue with the first unserviced 
request) , and the user process will be interrupted. One of 
the requests may be to close the device, in which case that 
request will be treated as the last request, no further 
transfer will take place, and the device will become 
available to another process. 
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Layout of Request Entry- 
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Figure 2 
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Interval 





1-5 
6-23 




Description 

I If this bit is set, the user 
process will be interrupted 
when the associated operation 
is completed. 

OP Operation to be performed 

N Immediate operand 

ER This bit is set if any 

persistent error occurred 
during the associated operation 



1-5 



ERC Device dependent error code 
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Word 
Interval 



Bit 
Interval 



Description 



6-23 ERDATA Error diagnostic information 

SA Target address in COMF 

WC Word count for data to be 
transferred 



4-7 



DTl-4 Direct data or, on error, 
diagnostic information 
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III Detailed Description of Opcodes 

(Note: the tape operations are basically analogues of the op- 
erations described in the IBM manual on the 2400 series tape 
units . ) 

1 Read 

Read a block of information from tape to SA in COMF, 
maximum of WC words. WC will be set to the total 
number of words in the block read. 

2 Read backward 

Same as Read, but tape moves backwards. Information 
is stored forwards starting at SA . 

3 Write 

Write a block on tape from SA in COMF, length deter- 
mined by WC 

4 Tape motion control N times 

DTI = Rewind 1 ± gnored ) 

1 Rewind and unload J 

2 Write Erase Gap 

3 Write Tape Mark 

4 Backspace Block 

5 Backspace File 

6 Forward Space Block 

7 Forward Space File 

Note for all above tape commands if N > 1 then it specifies 
the number of times the operation is to be performed. 
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5 Set modes for tape unit. The low order 5 bits of N 
contain the mode setting information as described in 
the IBM tape drive manual A22-6866, page 12. 

6 Read from cards 

Read N cards or until EOF on card reader. DTI < 0, 
EBCDIC, else card image. WC is set to number of cards 
read. Cards are not packed or encoded in any way. 

7 Print 

Print WC words of data starting at SA in COMF. Data 
should be in the form of lines, first word of which 
specifies length of line in characters and carriage 
control: 






CC 
7 


N 
9 ^ 






rest of which is a string of N 8-bit characters, 
< N < 133 

8 Mount Print Chain N 

Should be preceded by message to operator 

9 Send message to operator 

N < expect reply. SA gives starting address in COMF, 
WC gives character count. DTI gives starting address 
for reply, DT2 be set to the actual number of characters 
in the message received. 
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10 Close device 
Closes the open device and terminates all further 
communications between the user process and M30COM. 
This operation always generates an interrupt. 

11 Sense Device 
Reads the sense bytes for the open device to SA in 
COMF, one byte per word. N < 1, first two words will 
contain unit status byte and channel status byte from 
CSW. 

12 Set error correction mode 
N < no retries on error 

N ^_ normal retries will be attempted on error (de- 
fault mode) 

13 Acknowledge error 
Tells M30COM that the user process is aware that the 
last request generated an error. This must be 
the first entry in the first request block sent after 
an error. (This guards against crossed signals 
after an error) . 

Note 1: All addresses (such as SA) used in communication with 
M30COM must be relative to word page of COMF. 

Note 2: For all commands SA and SA+EWC-1 must lie in the saifie 

page of COMF where EWC is WC for word-oriented operations, 
(WC+2)/3 for character-oriented operations . 
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APPENDIX I 



A Device Numbers 

1 Card Reader 

2 printer 

3 7 -track drive 

4 9 -track drive No. 1 

B Chain Numbers 

1 PN 

2 TN 



C Carriage control Codes 

0-3 Skip 0-3 lines before printing 

17-28 Skip to channel 1-12 before printing 



